---
id: workflow
title: Temporal CLI workflow command reference
sidebar_label: workflow
description: Temporal Workflow commands enable operations on Workflow Executions, such as cancel, count, delete, describe, execute, list, query, reset, reset-batch, show, signal, stack, start, terminate, trace, and update, enhancing efficiency and control.
toc_max_heading_level: 4
keywords:
  - call stack
  - cancellation
  - child workflows
  - cli reference
  - command-line-interface-cli
  - event history
  - query
  - resets-feature
  - signals
  - signals-feature
  - stack trace
  - temporal cli
  - termination
  - workflow
  - workflow cancel
  - workflow count
  - workflow delete
  - workflow describe
  - workflow execute
  - workflow execution
  - workflow list
  - workflow query
  - workflow reset
  - workflow reset-batch
  - workflow show
  - workflow signal
  - workflow stack
  - workflow start
  - workflow terminate
  - workflow trace
tags:
  - Temporal CLI
  - Workflows
---

[Workflow](/workflows) commands allow operations to be performed on [Workflow Executions](/workflows#workflow-execution).

Workflow commands use this syntax:
`temporal workflow COMMAND [ARGS]`.

## cancel

The `temporal workflow cancel` command cancels a [Workflow Execution](/workflows#workflow-execution).

Canceling a running Workflow Execution records a [`WorkflowExecutionCancelRequested` event](/references/events#workflowexecutioncancelrequested) in the [Event History](/workflows#event-history).
A new [Workflow Task](/workers#workflow-task) will be scheduled, and the Workflow Execution performs cleanup work.

`temporal workflow cancel --workflow-id=meaningful-business-id`

In addition to Workflow IDs, Workflows can also be cancelled by a [List Filter](/visibility#list-filter).
`temporal workflow cancel --query=MyListFilter`

Use the following options to change the behavior of this command.

- [--fields](/cli/cmd-options#fields)

- [--address](/cli/cmd-options#address)

- [--codec-auth](/cli/cmd-options#codec-auth)

- [--codec-endpoint](/cli/cmd-options#codec-endpoint)

- [--color](/cli/cmd-options#color)

- [--command-timeout](/cli/cmd-options#command-timeout)

- [--env](/cli/cmd-options#env)

- [--grpc-meta](/cli/cmd-options#grpc-meta)

- [--namespace](/cli/cmd-options#namespace)

- [--query](/cli/cmd-options#query)

- [--reason](/cli/cmd-options#reason)

- [--run-id](/cli/cmd-options#run-id)

- [--tls](/cli/cmd-options#tls)

- [--tls-ca-path](/cli/cmd-options#tls-ca-path)

- [--tls-cert-path](/cli/cmd-options#tls-cert-path)

- [--tls-disable-host-verification](/cli/cmd-options#tls-disable-host-verification)

- [--tls-key-path](/cli/cmd-options#tls-key-path)

- [--tls-server-name](/cli/cmd-options#tls-server-name)

- [--workflow-id](/cli/cmd-options#workflow-id)

- [--yes](/cli/cmd-options#yes)

## count

The `temporal workflow count` command returns a count of [Workflow Executions](/workflows#workflow-execution).
This command requires Elasticsearch to be enabled.

Use the following options to change the command's behavior.

- [--address](/cli/cmd-options#address)

- [--codec-auth](/cli/cmd-options#codec-auth)

- [--codec-endpoint](/cli/cmd-options#codec-endpoint)

- [--color](/cli/cmd-options#color)

- [--command-timeout](/cli/cmd-options#command-timeout)

- [--env](/cli/cmd-options#env)

- [--grpc-meta](/cli/cmd-options#grpc-meta)

- [--namespace](/cli/cmd-options#namespace)

- [--query](/cli/cmd-options#query)

- [--tls](/cli/cmd-options#tls)

- [--tls-ca-path](/cli/cmd-options#tls-ca-path)

- [--tls-cert-path](/cli/cmd-options#tls-cert-path)

- [--tls-disable-host-verification](/cli/cmd-options#tls-disable-host-verification)

- [--tls-key-path](/cli/cmd-options#tls-key-path)

- [--tls-server-name](/cli/cmd-options#tls-server-name)

## delete

The `temporal workflow delete` command deletes the specified [Workflow Execution](/workflows#workflow-execution).

Use the following options to change the command's behavior.

- [--address](/cli/cmd-options#address)

- [--codec-auth](/cli/cmd-options#codec-auth)

- [--codec-endpoint](/cli/cmd-options#codec-endpoint)

- [--color](/cli/cmd-options#color)

- [--command-timeout](/cli/cmd-options#command-timeout)

- [--env](/cli/cmd-options#env)

- [--grpc-meta](/cli/cmd-options#grpc-meta)

- [--namespace](/cli/cmd-options#namespace)

- [--query](/cli/cmd-options#query)

- [--reason](/cli/cmd-options#reason)

- [--run-id](/cli/cmd-options#run-id)

- [--tls](/cli/cmd-options#tls)

- [--tls-ca-path](/cli/cmd-options#tls-ca-path)

- [--tls-cert-path](/cli/cmd-options#tls-cert-path)

- [--tls-disable-host-verification](/cli/cmd-options#tls-disable-host-verification)

- [--tls-key-path](/cli/cmd-options#tls-key-path)

- [--tls-server-name](/cli/cmd-options#tls-server-name)

- [--workflow-id](/cli/cmd-options#workflow-id)

- [--yes](/cli/cmd-options#yes)

## describe

The `temporal workflow describe` command shows information about a given [Workflow Execution](/workflows#workflow-execution).
This information can be used to locate Workflow Executions that weren't able to run successfully.

`temporal workflow describe --workflow-id=meaningful-business-id`

The output of this command can be changed to show as printed ('raw') or to only show the Workflow Execution's auto-reset points.

`temporal workflow describe --workflow-id=meaningful-business-id --raw=true --reset-points=true`

Use the following command options to change the information returned by this command.

- [--address](/cli/cmd-options#address)

- [--codec-auth](/cli/cmd-options#codec-auth)

- [--codec-endpoint](/cli/cmd-options#codec-endpoint)

- [--color](/cli/cmd-options#color)

- [--command-timeout](/cli/cmd-options#command-timeout)

- [--env](/cli/cmd-options#env)

- [--grpc-meta](/cli/cmd-options#grpc-meta)

- [--namespace](/cli/cmd-options#namespace)

- [--raw](/cli/cmd-options#raw)

- [--reset-points](/cli/cmd-options#reset-points)

- [--run-id](/cli/cmd-options#run-id)

- [--tls](/cli/cmd-options#tls)

- [--tls-ca-path](/cli/cmd-options#tls-ca-path)

- [--tls-cert-path](/cli/cmd-options#tls-cert-path)

- [--tls-disable-host-verification](/cli/cmd-options#tls-disable-host-verification)

- [--tls-key-path](/cli/cmd-options#tls-key-path)

- [--tls-server-name](/cli/cmd-options#tls-server-name)

- [--workflow-id](/cli/cmd-options#workflow-id)

## execute

The `temporal workflow execute` command starts a new [Workflow Execution](/workflows#workflow-execution) and prints its progress.
The command doesn't finish until the Workflow Execution completes.

To execute a [Workflow](/workflows) from the Temporal CLI:
`temporal workflow execute --workflow-id=meaningful-business-id --type=MyWorkflow --task-queue=MyTaskQueue`

Single quotes('') are used to wrap input as JSON.

`temporal workflow execute --workflow-id=meaningful-business-id --type-MyWorkflow --task-queue-MyTaskQueue --input='{"JSON": "Input"}'`

Use the following command options to change how the Workflow Execution behaves during its run.

- [--address](/cli/cmd-options#address)

- [--codec-auth](/cli/cmd-options#codec-auth)

- [--codec-endpoint](/cli/cmd-options#codec-endpoint)

- [--color](/cli/cmd-options#color)

- [--command-timeout](/cli/cmd-options#command-timeout)

- [--cron](/cli/cmd-options#cron)

- [--env](/cli/cmd-options#env)

- [--execution-timeout](/cli/cmd-options#execution-timeout)

- [--fields](/cli/cmd-options#fields)

- [--grpc-meta](/cli/cmd-options#grpc-meta)

- [--id-reuse-policy](/cli/cmd-options#id-reuse-policy)

- [--input](/cli/cmd-options#input)

- [--input-file](/cli/cmd-options#input-file)

- [--limit](/cli/cmd-options#limit)

- [--max-field-length](/cli/cmd-options#max-field-length)

- [--memo](/cli/cmd-options#memo)

- [--memo-file](/cli/cmd-options#memo-file)

- [--namespace](/cli/cmd-options#namespace)

- [--no-pager](/cli/cmd-options#no-pager)

- [--output](/cli/cmd-options#output)

- [--pager](/cli/cmd-options#pager)

- [--run-timeout](/cli/cmd-options#run-timeout)

- [--search-attribute](/cli/cmd-options#search-attribute)

- [--start-delay](/cli/cmd-options#start-delay)

- [--task-queue](/cli/cmd-options#task-queue)

- [--task-timeout](/cli/cmd-options#task-timeout)

- [--time-format](/cli/cmd-options#time-format)

- [--tls](/cli/cmd-options#tls)

- [--tls-ca-path](/cli/cmd-options#tls-ca-path)

- [--tls-cert-path](/cli/cmd-options#tls-cert-path)

- [--tls-disable-host-verification](/cli/cmd-options#tls-disable-host-verification)

- [--tls-key-path](/cli/cmd-options#tls-key-path)

- [--tls-server-name](/cli/cmd-options#tls-server-name)

- [--type](/cli/cmd-options#type)

- [--workflow-id](/cli/cmd-options#workflow-id)

## list

The `temporal workflow list` command provides a list of [Workflow Executions](/workflows#workflow-execution) that meet the criteria of a given [List Filter](/visibility#list-filter).
By default, this command returns a list of up to 10 closed Workflow Executions.

`temporal workflow list --query=MyListFilter`

The command can also return a list of archived Workflow Executions.

`temporal workflow list --archived=true`

Use the following command options to change the information returned by this command.

- [--address](/cli/cmd-options#address)

- [--archived](/cli/cmd-options#archived)

- [--codec-auth](/cli/cmd-options#codec-auth)

- [--codec-endpoint](/cli/cmd-options#codec-endpoint)

- [--color](/cli/cmd-options#color)

- [--command-timeout](/cli/cmd-options#command-timeout)

- [--env](/cli/cmd-options#env)

- [--fields](/cli/cmd-options#fields)

- [--grpc-meta](/cli/cmd-options#grpc-meta)

- [--limit](/cli/cmd-options#limit)

- [--namespace](/cli/cmd-options#namespace)

- [--no-pager](/cli/cmd-options#no-pager)

- [--output](/cli/cmd-options#output)

- [--pager](/cli/cmd-options#pager)

- [--query](/cli/cmd-options#query)

- [--time-format](/cli/cmd-options#time-format)

- [--tls](/cli/cmd-options#tls)

- [--tls-ca-path](/cli/cmd-options#tls-ca-path)

- [--tls-cert-path](/cli/cmd-options#tls-cert-path)

- [--tls-disable-host-verification](/cli/cmd-options#tls-disable-host-verification)

- [--tls-key-path](/cli/cmd-options#tls-key-path)

- [--tls-server-name](/cli/cmd-options#tls-server-name)

## query

The `temporal workflow query` command sends a [Query](/encyclopedia/workflow-message-passing#sending-queries) to a [Workflow Execution](/workflows#workflow-execution).

Queries can retrieve all or part of the Workflow state within given parameters.
Queries can also be used on completed [Workflows](/workflows#workflow-execution).

`temporal workflow query --workflow-id=meaningful-business-id --type=MyQueryType`

Use the following command options to change the information returned by this command.

- [--address](/cli/cmd-options#address)

- [--codec-auth](/cli/cmd-options#codec-auth)

- [--codec-endpoint](/cli/cmd-options#codec-endpoint)

- [--color](/cli/cmd-options#color)

- [--command-timeout](/cli/cmd-options#command-timeout)

- [--env](/cli/cmd-options#env)

- [--grpc-meta](/cli/cmd-options#grpc-meta)

- [--input](/cli/cmd-options#input)

- [--input-file](/cli/cmd-options#input-file)

- [--namespace](/cli/cmd-options#namespace)

- [--reject-condition](/cli/cmd-options#reject-condition)

- [--run-id](/cli/cmd-options#run-id)

- [--tls](/cli/cmd-options#tls)

- [--tls-ca-path](/cli/cmd-options#tls-ca-path)

- [--tls-cert-path](/cli/cmd-options#tls-cert-path)

- [--tls-disable-host-verification](/cli/cmd-options#tls-disable-host-verification)

- [--tls-key-path](/cli/cmd-options#tls-key-path)

- [--tls-server-name](/cli/cmd-options#tls-server-name)

- [--type](/cli/cmd-options#type)

- [--workflow-id](/cli/cmd-options#workflow-id)

## reset

The `temporal workflow reset` command resets a [Workflow Execution](/workflows#workflow-execution).
A reset resumes the Workflow from a certain point without losing your parameters or [Event History](/workflows#event-history).

The Workflow Execution can be set to a given [Event Type](/workflows#event).
For example, `temporal workflow reset --workflow-id=meaningful-business-id --type=LastContinuedAsNew`.

The Workflow Execution can also be reset to any Event after WorkflowTaskStarted.
For example, `temporal workflow reset --workflow-id=meaningful-business-id --event-id=MyLastEvent`.

Use the following options to change reset behavior.

- [--address](/cli/cmd-options#address)

- [--codec-auth](/cli/cmd-options#codec-auth)

- [--codec-endpoint](/cli/cmd-options#codec-endpoint)

- [--color](/cli/cmd-options#color)

- [--command-timeout](/cli/cmd-options#command-timeout)

- [--env](/cli/cmd-options#env)

- [--event-id](/cli/cmd-options#event-id)

- [--grpc-meta](/cli/cmd-options#grpc-meta)

- [--namespace](/cli/cmd-options#namespace)

- [--reapply-type](/cli/cmd-options#reapply-type)

- [--reason](/cli/cmd-options#reason)

- [--run-id](/cli/cmd-options#run-id)

- [--tls](/cli/cmd-options#tls)

- [--tls-ca-path](/cli/cmd-options#tls-ca-path)

- [--tls-cert-path](/cli/cmd-options#tls-cert-path)

- [--tls-disable-host-verification](/cli/cmd-options#tls-disable-host-verification)

- [--tls-key-path](/cli/cmd-options#tls-key-path)

- [--tls-server-name](/cli/cmd-options#tls-server-name)

- [--type](/cli/cmd-options#type)

- [--workflow-id](/cli/cmd-options#workflow-id)

## reset-batch

The `temporal workflow reset-batch` command resets multiple [Workflow Executions](/workflows#workflow-execution) by `resetType`.
Resetting a [Workflow](/workflows) resumes it from a certain point without losing your parameters or [Event History](/workflows#event-history).

The set of Workflow Executions to reset can be specified in an input file.
The input file must have a [Workflow ID](/workflows#workflow-id) on each line.

`temporal workflow reset-batch --input-file=MyInput --input-separator="\t"`

Workflow Executions can also be queried by a [List Filter](/visibility#list-filter).
`temporal workflow reset-batch --query=MyListFilter`

Use the following options to change reset behavior.

- [--address](/cli/cmd-options#address)

- [--codec-auth](/cli/cmd-options#codec-auth)

- [--codec-endpoint](/cli/cmd-options#codec-endpoint)

- [--color](/cli/cmd-options#color)

- [--command-timeout](/cli/cmd-options#command-timeout)

- [--dry-run](/cli/cmd-options#dry-run)

- [--env](/cli/cmd-options#env)

- [--exclude-file](/cli/cmd-options#exclude-file)

- [--grpc-meta](/cli/cmd-options#grpc-meta)

- [--input-file](/cli/cmd-options#input-file)

- [--input-parallelism](/cli/cmd-options#input-parallelism)

- [--input-separator](/cli/cmd-options#input-separator)

- [--namespace](/cli/cmd-options#namespace)

- [--non-deterministic](/cli/cmd-options#non-deterministic)

- [--query](/cli/cmd-options#query)

- [--reason](/cli/cmd-options#reason)

- [--skip-base-is-not-current](/cli/cmd-options#skip-base-is-not-current)

- [--skip-current-open](/cli/cmd-options#skip-current-open)

- [--tls](/cli/cmd-options#tls)

- [--tls-ca-path](/cli/cmd-options#tls-ca-path)

- [--tls-cert-path](/cli/cmd-options#tls-cert-path)

- [--tls-disable-host-verification](/cli/cmd-options#tls-disable-host-verification)

- [--tls-key-path](/cli/cmd-options#tls-key-path)

- [--tls-server-name](/cli/cmd-options#tls-server-name)

- [--type](/cli/cmd-options#type)

## show

The `temporal workflow show` command provides the [Event History](/workflows#event-history) for a [Workflow Execution](/workflows#workflow-execution).

Use the following options to change the behavior of this command.

- [--address](/cli/cmd-options#address)

- [--codec-auth](/cli/cmd-options#codec-auth)

- [--codec-endpoint](/cli/cmd-options#codec-endpoint)

- [--color](/cli/cmd-options#color)

- [--command-timeout](/cli/cmd-options#command-timeout)

- [--env](/cli/cmd-options#env)

- [--fields](/cli/cmd-options#fields)

- [--follow](/cli/cmd-options#follow)

- [--grpc-meta](/cli/cmd-options#grpc-meta)

- [--limit](/cli/cmd-options#limit)

- [--max-field-length](/cli/cmd-options#max-field-length)

- [--namespace](/cli/cmd-options#namespace)

- [--no-pager](/cli/cmd-options#no-pager)

- [--output](/cli/cmd-options#output)

- [--pager](/cli/cmd-options#pager)

- [--reset-points](/cli/cmd-options#reset-points)

- [--run-id](/cli/cmd-options#run-id)

- [--time-format](/cli/cmd-options#time-format)

- [--tls](/cli/cmd-options#tls)

- [--tls-ca-path](/cli/cmd-options#tls-ca-path)

- [--tls-cert-path](/cli/cmd-options#tls-cert-path)

- [--tls-disable-host-verification](/cli/cmd-options#tls-disable-host-verification)

- [--tls-key-path](/cli/cmd-options#tls-key-path)

- [--tls-server-name](/cli/cmd-options#tls-server-name)

- [--workflow-id](/cli/cmd-options#workflow-id)

## signal

The `temporal workflow signal` command is used to send a [Signal](/encyclopedia/workflow-message-passing#sending-signals) to a [Workflow Execution](/workflows#workflow-execution) by [Workflow Id](/workflows#workflow-id) or [List Filter](/visibility#list-filter).

Use the following options to change the command's behavior.

- [--address](/cli/cmd-options#address)

- [--codec-auth](/cli/cmd-options#codec-auth)

- [--codec-endpoint](/cli/cmd-options#codec-endpoint)

- [--color](/cli/cmd-options#color)

- [--command-timeout](/cli/cmd-options#command-timeout)

- [--env](/cli/cmd-options#env)

- [--grpc-meta](/cli/cmd-options#grpc-meta)

- [--input](/cli/cmd-options#input)

- [--input-file](/cli/cmd-options#input-file)

- [--name](/cli/cmd-options#name)

- [--namespace](/cli/cmd-options#namespace)

- [--query](/cli/cmd-options#query)

- [--reason](/cli/cmd-options#reason)

- [--run-id](/cli/cmd-options#run-id)

- [--tls](/cli/cmd-options#tls)

- [--tls-ca-path](/cli/cmd-options#tls-ca-path)

- [--tls-cert-path](/cli/cmd-options#tls-cert-path)

- [--tls-disable-host-verification](/cli/cmd-options#tls-disable-host-verification)

- [--tls-key-path](/cli/cmd-options#tls-key-path)

- [--tls-server-name](/cli/cmd-options#tls-server-name)

- [--workflow-id](/cli/cmd-options#workflow-id)

- [--yes](/cli/cmd-options#yes)

## stack

The `temporal workflow stack` command queries a [Workflow Execution](/workflows#workflow-execution) with `--stack-trace` as the [Query](/encyclopedia/workflow-message-passing#stack-trace-query) type.
Returning the call stack of all the threads owned by a Workflow Execution can be great for troubleshooting in production.

Use the following options to change the command's behavior.

- [--address](/cli/cmd-options#address)

- [--codec-auth](/cli/cmd-options#codec-auth)

- [--codec-endpoint](/cli/cmd-options#codec-endpoint)

- [--color](/cli/cmd-options#color)

- [--command-timeout](/cli/cmd-options#command-timeout)

- [--env](/cli/cmd-options#env)

- [--grpc-meta](/cli/cmd-options#grpc-meta)

- [--input](/cli/cmd-options#input)

- [--input-file](/cli/cmd-options#input-file)

- [--namespace](/cli/cmd-options#namespace)

- [--reject-condition](/cli/cmd-options#reject-condition)

- [--run-id](/cli/cmd-options#run-id)

- [--tls](/cli/cmd-options#tls)

- [--tls-ca-path](/cli/cmd-options#tls-ca-path)

- [--tls-cert-path](/cli/cmd-options#tls-cert-path)

- [--tls-disable-host-verification](/cli/cmd-options#tls-disable-host-verification)

- [--tls-key-path](/cli/cmd-options#tls-key-path)

- [--tls-server-name](/cli/cmd-options#tls-server-name)

- [--workflow-id](/cli/cmd-options#workflow-id)

## start

The `temporal workflow start` command starts a new [Workflow Execution](/workflows#workflow-execution).
When invoked successfully, the Workflow and Run ID are returned immediately after starting the [Workflow](/workflows).

`temporal workflow start --task-queue=MyTaskQueue --type=MyWorkflow`

Use the following command options to change how the Workflow Execution behaves upon starting.

- [--address](/cli/cmd-options#address)

- [--codec-auth](/cli/cmd-options#codec-auth)

- [--codec-endpoint](/cli/cmd-options#codec-endpoint)

- [--color](/cli/cmd-options#color)

- [--command-timeout](/cli/cmd-options#command-timeout)

- [--cron](/cli/cmd-options#cron)

- [--env](/cli/cmd-options#env)

- [--execution-timeout](/cli/cmd-options#execution-timeout)

- [--fields](/cli/cmd-options#fields)

- [--grpc-meta](/cli/cmd-options#grpc-meta)

- [--id-reuse-policy](/cli/cmd-options#id-reuse-policy)

- [--input](/cli/cmd-options#input)

- [--input-file](/cli/cmd-options#input-file)

- [--limit](/cli/cmd-options#limit)

- [--max-field-length](/cli/cmd-options#max-field-length)

- [--memo](/cli/cmd-options#memo)

- [--memo-file](/cli/cmd-options#memo-file)

- [--namespace](/cli/cmd-options#namespace)

- [--no-pager](/cli/cmd-options#no-pager)

- [--output](/cli/cmd-options#output)

- [--pager](/cli/cmd-options#pager)

- [--run-timeout](/cli/cmd-options#run-timeout)

- [--search-attribute](/cli/cmd-options#search-attribute)

- [--start-delay](/cli/cmd-options#start-delay)

- [--task-queue](/cli/cmd-options#task-queue)

- [--task-timeout](/cli/cmd-options#task-timeout)

- [--time-format](/cli/cmd-options#time-format)

- [--tls](/cli/cmd-options#tls)

- [--tls-ca-path](/cli/cmd-options#tls-ca-path)

- [--tls-cert-path](/cli/cmd-options#tls-cert-path)

- [--tls-disable-host-verification](/cli/cmd-options#tls-disable-host-verification)

- [--tls-key-path](/cli/cmd-options#tls-key-path)

- [--tls-server-name](/cli/cmd-options#tls-server-name)

- [--type](/cli/cmd-options#type)

- [--workflow-id](/cli/cmd-options#workflow-id)

## terminate

The `temporal workflow terminate` command terminates a [Workflow Execution](/workflows#workflow-execution)

Terminating a running Workflow Execution records a [`WorkflowExecutionTerminated` event](/references/events#workflowexecutionterminated) as the closing Event in the [Event History](/workflows#event-history).
Any further [Command](/workflows#command) Tasks cannot be scheduled after running this command.

Workflow terminations require a valid [Workflow ID](/workflows#workflow-id) to function.
`temporal workflow terminate --workflow-id=meaningful-business-id`

Use the following options to change termination behavior.

- [--address](/cli/cmd-options#address)

- [--codec-auth](/cli/cmd-options#codec-auth)

- [--codec-endpoint](/cli/cmd-options#codec-endpoint)

- [--color](/cli/cmd-options#color)

- [--command-timeout](/cli/cmd-options#command-timeout)

- [--env](/cli/cmd-options#env)

- [--grpc-meta](/cli/cmd-options#grpc-meta)

- [--namespace](/cli/cmd-options#namespace)

- [--query](/cli/cmd-options#query)

- [--reason](/cli/cmd-options#reason)

- [--run-id](/cli/cmd-options#run-id)

- [--tls](/cli/cmd-options#tls)

- [--tls-ca-path](/cli/cmd-options#tls-ca-path)

- [--tls-cert-path](/cli/cmd-options#tls-cert-path)

- [--tls-disable-host-verification](/cli/cmd-options#tls-disable-host-verification)

- [--tls-key-path](/cli/cmd-options#tls-key-path)

- [--tls-server-name](/cli/cmd-options#tls-server-name)

- [--workflow-id](/cli/cmd-options#workflow-id)

- [--yes](/cli/cmd-options#yes)

## trace

The `temporal workflow trace` command tracks the progress of a [Workflow Execution](/workflows#workflow-execution) and any [Child Workflows](/encyclopedia/child-workflows) it generates.

Use the following options to change the command's behavior.

- [--address](/cli/cmd-options#address)

- [--codec-auth](/cli/cmd-options#codec-auth)

- [--codec-endpoint](/cli/cmd-options#codec-endpoint)

- [--color](/cli/cmd-options#color)

- [--concurrency](/cli/cmd-options#concurrency)

- [--command-timeout](/cli/cmd-options#command-timeout)

- [--depth](/cli/cmd-options#depth)

- [--env](/cli/cmd-options#env)

- [--fold](/cli/cmd-options#fold)

- [--grpc-meta](/cli/cmd-options#grpc-meta)

- [--namespace](/cli/cmd-options#namespace)

- [--no-fold](/cli/cmd-options#no-fold)

- [--run-id](/cli/cmd-options#run-id)

- [--tls](/cli/cmd-options#tls)

- [--tls-ca-path](/cli/cmd-options#tls-ca-path)

- [--tls-cert-path](/cli/cmd-options#tls-cert-path)

- [--tls-disable-host-verification](/cli/cmd-options#tls-disable-host-verification)

- [--tls-key-path](/cli/cmd-options#tls-key-path)

- [--tls-server-name](/cli/cmd-options#tls-server-name)

- [--workflow-id](/cli/cmd-options#workflow-id)

## update

The `temporal workflow update` command synchronously updates a running [Workflow Execution](/workflows#workflow-execution).

Use the options listed below to change the command's behavior.

- [--address](/cli/cmd-options#address)

- [--codec-auth](/cli/cmd-options#codec-auth)

- [--codec-endpoint](/cli/cmd-options#codec-endpoint)

- [--color](/cli/cmd-options#color)

- [--command-timeout](/cli/cmd-options#command-timeout)

- [--env](/cli/cmd-options#env)

- [--first-execution-run-id](/cli/cmd-options#first-execution-run-id)

- [--grpc-meta](/cli/cmd-options#grpc-meta)

- [--input](/cli/cmd-options#input)

- [--name](/cli/cmd-options#name)

- [--namespace](/cli/cmd-options#namespace)

- [--run-id](/cli/cmd-options#run-id)

- [--tls](/cli/cmd-options#tls)

- [--tls-ca-path](/cli/cmd-options#tls-ca-path)

- [--tls-cert-path](/cli/cmd-options#tls-cert-path)

- [--tls-disable-host-verification](/cli/cmd-options#tls-disable-host-verification)

- [--tls-key-path](/cli/cmd-options#tls-key-path)

- [--tls-server-name](/cli/cmd-options#tls-server-name)

- [--workflow-id](/cli/cmd-options#workflow-id)
